Skip to main content

Uso de la interfaz de línea de comandos

Tu puedes empezar CODESYS.exe desde la línea de comando con las siguientes opciones y argumentos.

Sintaxis:

<installation folder>CODESYS.exe --<Option>

Nota

Si has usado el CODESYS Installer para instalar varios CODESYS instancias en su computadora, entonces necesita usar el --additionalfolder opción para especificar la instancia que se lanzará.

Sugerencia

Las rutas o los parámetros de opciones deben escribirse entre comillas rectas cuando contienen espacios, guiones o barras inclinadas.

Opción: --carpeta adicional

Aplica sólo a instalaciones realizadas con el CODESYS Installer:

Si ha instalado varias instancias de un CODESYS versión y desea iniciar una de las instancias desde la línea de comando, entonces se aplica lo siguiente: Además del perfil, también debe especificar la ruta absoluta de la AddionalFolder/<instance name> con el --additionalfolder opción.

Antecedentes: El CODESYS Installer crea un AdditionalFolders subcarpeta en el directorio de instalación en el CODESYS carpeta. En esta carpeta, hay una subcarpeta separada para cada CODESYS instancia con los archivos individuales para perfil, complementos y PackageDB. Para la primera instancia instalada, la subcarpeta se llama Default. Las instancias adicionales reciben el nombre de instalación asignado durante la instalación.

Puede ver la ruta absoluta que se especificará para --additionalfolder en CODESYS Installer cuando haces clic en Cambiar en el mosaico de la instancia correspondiente. Está registrado como el Ubicación.

Sintaxis:

--additionalfolder=<AdditionalFolders\<instance installation name>>
ejemplo 44. Ejemplo

Dos instancias de CODESYS 3.5.18.20 se ha instalado en su computadora con el CODESYS Installer: uno para técnicos de servicio, otro para desarrolladores. Quieres ejecutar el Service instancia a través de un StartServiceScript.py script desde la línea de comando. Para hacer esto, especifique la opción --additionalfolder después de la opción --profile en la línea de comando de la siguiente manera:

"C:\Program Files (x86)\CODESYS3.5.18.20\CODESYS\Common\CODESYS.exe" --profile="CODESYS V3.5 SP18 --additionalfolder="C:\Program Files\CODESYS 3.5.18.20\CODESYS\AdditionalFolders\Service"  --runscript="D:\Dokumente\Scripting\StartServiceScript.py"--scriptargs:'username password 3.14 "path=\"C:\temp\\\""'–noUI


Opción: --culture (idioma de la interfaz de usuario)

CODESYS se inicia en el idioma especificado.

Sintaxis:

--culture=<Culture>

<culture>: Los códigos de idioma típicos son los siguientes: de, en, fr, it, es, zh-CHS.

ejemplo 45. Ejemplo

A partir de CODESYS con la interfaz de usuario en inglés:

CODESYS.exe --culture=en


Opción: --profile (CODESYS perfil)

CODESYS se inicia directamente con el perfil especificado. Cuando empieces CODESYS sin esta opción, el Seleccionar un perfil se abre

Sintaxis:

--profile="<profile name>"

<profile name>: Debe especificar el nombre del perfil exactamente como se muestra en el Ayuda → Acerca de pantalla de inicio del sistema de desarrollo o en el menú de inicio de su computadora.

ejemplo 46. Ejemplo
CODESYS.exe --culture=de --profile="CODESYS V3.6"


Opción: --compare (comenzar comparación de proyectos)

Después CODESYS se inicia, la comparación de dos CODESYS proyectos se inicia de inmediato. Después de la opción, primero especifique el "proyecto actual" y luego el "proyecto de referencia" como argumentos. CODESYS inicia y abre el Comparación de proyectos: diferencias vista.

Sintaxis:

--compare="<path of project file>" "<path of reference project file>"
ejemplo 47. Ejemplo
CODESYS.exe --compare  "D:\proj\project1.project"  "D:\proj\project2.project"


Opción: --project (abrir CODESYS proyecto)

CODESYS se inicia y se abre el proyecto especificado.

Sintaxis:

--project="<path of project file>"

<path of project file>: Ruta del archivo del proyecto

ejemplo 48. Ejemplo

Abre el test proyecto:

CODESYS.exe --culture=de --project="D:\projects\test.project"


Opción: --projectarchive (abrir CODESYS archivo del proyecto)

CODESYS se inicia, se extrae el archivo del proyecto especificado y se abre el proyecto.

Sintaxis:

--projectarchive="<path of projectarchive file>"

<path of project archive file>: ruta de archivo del archivo del proyecto

ejemplo 49. Ejemplo

Extrae el test.projectarchive y abra el proyecto en el sistema de desarrollo:

CODESYS.exe --projectarchive="D:\projects\test.projectarchive"


Opción: --runscript (ejecutar script)

El archivo de script especificado es ejecutado por CODESYS.

tabla 8. Opciones de línea de comandos para --runscript

--runscript="<script file>.py"

CODESYS corre el <script file>.py archivo de script al inicio.

Debe proporcionar la ruta completa del archivo de script.

--scriptargs:'<arg1> <arg2> ... <argn>'

Utilice esta opción con el --runscript opción. Activan el paso de los argumentos <arg1> … <argn> al script. Los argumentos se pasan a la variable Python sys.argv.

--noUI

Utilice esta opción con el --runscript opción.

El CODESYS la interfaz de usuario no está abierta. CODESYS genera todos los errores, advertencias, informes del compilador y mensajes de línea de comandos generados desde el script. Los mensajes del script (1: Texto de gravedad) se pueden separar de otros mensajes (2: Error fatal de gravedad, Error, Advertencia, Información) con el > operador.

--enablescripttracing

Utilice esta opción con el --runscript opción. Como resultado, cada comando del archivo de script se muestra en la salida.

--textPrompts

Utilice esta opción con el --noUI opción. Como resultado, los métodos de servicio de mensajes y los cuadros de diálogo predeterminados se muestran en la línea de comando para la entrada del usuario.

Si no especifica --textPrompts, todas las indicaciones del servicio de mensajes se confirman automáticamente con los valores predeterminados.

scriptdebugger {="<debugger>"}

Utilice esta opción con el --runscript opción. Establece IronPython en modo de depuración para que se puedan usar depuradores externos para depurar scripts de Python. Los siguientes valores están definidos para <depurador> (no distingue entre mayúsculas y minúsculas):

  • auto: detecta automáticamente si se incluye un depurador en cada secuencia de comandos para el proceso actual. En este momento, solo los depuradores basados en .NET se pueden detectar automáticamente. Un depurador detectado sobrescribe el --enablescripttracing bandera.

  • .NET: activa la depuración para depuradores basados en .NET, como "Python Tools for Visual Studio" (PTVS) y SharpDevelop. Con esta opción, también se puede incluir un depurador en los scripts en ejecución, a diferencia de "automático".

    Nota: Este es actualmente el valor predeterminado cuando --scriptdebugger se utiliza sin proporcionar un valor.

  • disabled: Desactiva la depuración y detección automática.

  • script: cambia el motor de secuencias de comandos de IronPython al modo de depuración para activar la depuración para los depuradores de seguimiento. El propio script debe conectarse y desconectarse del depurador.

  • tracing: Activa el modo "script tracing" integrado simple y desactiva la detección automática (igual que la opción --scripttracing).

  • $absolute_path.py$: ruta absoluta a un script de Python que inicia la conexión a un depurador basado en Python. El motor de secuencias de comandos de IronPython se cambia al modo de depuración para permitir la depuración de los depuradores de seguimiento. Este script se ejecuta una vez durante la inicialización y debe definir las siguientes funciones no parametrizadas:

    scriptdebuggersetup se ejecuta inmediatamente antes de ejecutar el script de usuario para establecer la conexión con el depurador.

    scriptdebuggershutdown se llama inmediatamente después de ejecutar la secuencia de comandos del usuario o cuando se descarga el motor de secuencias de comandos y debe cerrar la conexión con el depurador.



ejemplo 50. Ejemplos de uso de parámetros de transferencia en archivos de script con 'sys.argv'
start /b /wait CODESYS.exe
--runscript="D:\Script\ArgvAnd__main__Test.py"
--scriptargs:'username password 3.14 "path=\"C:\temp\\"'

Archivo de comandos: ArgvAnd__main__Test.py

from __future__ import print_function
import sys
print("sys.argv: ", len(sys.argv), " elements:")

for arg in sys.argv:
    print(" - ", arg)
print()
print("__name__: ", __name__)

Resultado de salida: stdout:

sys.argv: 6 elements:
- D:\TestScripts\ArgvAnd__main__Test.py
- username
- password
- 3.14
- path= "C:temp"
__name__: __main__

Para obtener más información sobre el __name__ variable global, consulte la documentación de Python.



ejemplo 51. Ejemplos de la salida del mensaje
start /b /wait CODESYS.exe --runscript="D:\Script\AmpelTest.py" --noUI 1>ScriptMessages.txt

CODESYS pasa todos los mensajes generados por el script al ScriptMessages.txt Archivo. Otros mensajes se imprimen en la línea de comando.

start /b /wait CODESYS.exe --runscript="D:\Script\AmpelTest.py" --noUI 2>NUL

CODESYS suprime todos los mensajes, excepto los mensajes de script. Los mensajes del script se imprimen en la línea de comandos.



ejemplo 52. Ejemplo de uso de la opción –scriptdebugger

La siguiente initdebug.py script fue probado con éxito con pydevddepuradores basados en, como PyDev/LiClipse y PyCharm. Para usar este script, comience CODESYS con la siguiente línea de comando:

--profile="Fanta Development Build" --scriptdebugger="D:\test\charmdebug\initdebug.py"

Archivo: initdebug.py:

from _future_ import print_function
from _future_ import unicode_literals
import sys
sys.path.append(r"D:\test\Env2\Lib\site-packages\pycharm-debug.egg")
import pydevd
def scriptdebuggersetup():
pydevd.settrace('localhost', port=51234, stdoutToServer=True, stderrToServer=True)
def scriptdebuggershutdown():
pydevd.stoptrace()


Para más información, ver: Uso de guiones y http://docs.python.org/tutorial/modules.html

Opción: --ignorewhitespace (ignorar espacios en blanco en la comparación de proyectos)

Si agrega esta opción después de la opción --compare <project1> <project2>, los espacios en blanco se ignoran en la comparación de proyectos. Tenga en cuenta que los espacios semánticamente relevantes, por ejemplo en STRING literales, todavía se tienen en cuenta.

Sintaxis

--compare="<path of project file>" "<path of reference project file>" --ignorewhitespace="true"|"false"
ejemplo 53. Ejemplo
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignorewhitespace="true"


Opción: --ignorecomments (ignorar comentarios en la comparación de proyectos)

Si agrega esta opción después de la opción --compare <project1> <project2>, los comentarios se ignoran en la comparación de proyectos.

Sintaxis:

--compare="<path of project file>" "<path of reference project file>" --ignorecomments="true"|"false"
ejemplo 54. Ejemplo
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignorecomments="true"


Opción: --ignoreproperties (ignorar las propiedades del objeto en la comparación de proyectos)

Si agrega esta opción después de la opción --compare <project1> <project2>, las propiedades del objeto (permisos, configuración de compilación, directorios, mapas de bits, etc.) se ignoran en la comparación de proyectos.

Sintaxis:

--compare="<path of project file>" "<path of reference project file>" --ignoreproperties="true"|"false"
ejemplo 55. Ejemplo
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignoreproperties="true"


Opción: --skipunlicensedplugins (no cargar componentes sin licencia)

CODESYS Está empezado. En este caso, se omite la consulta sobre si aún deben cargarse componentes sin licencia. Si es así, entonces CODESYS lo hace no cargar silenciosamente estos componentes.

ejemplo 56. Ejemplo
CODESYS.exe –skipunlicensedplugins


Opción: --signaturethumbprint (huella digital del certificado que se usa para firmar bibliotecas compiladas)

Si agrega esta opción después de la opción --project="<path of project file>", luego se abre el proyecto y se pasa la huella digital del certificado para firmar bibliotecas compiladas.

Sintaxis:

--signaturethumbprint="<thumbprint of digital signature>"
ejemplo 57. Ejemplo
CODESYS.exe --project="D:\projects\test.project" signaturethumbprint="3E96C9B61010CBDC3186021A1CAA64946DDCAAF3"


Opción: --enforcesignedcompiledlibraries (hacer cumplir la firma de bibliotecas compiladas)

Si agrega esta opción después de la opción --project="<path of project file>", entonces la Hacer cumplir la firma de bibliotecas compiladas opción está habilitada en el proyecto en el Pantalla de seguridad sobre el Usuario pestaña.

Importante

Cuando el Pantalla de seguridad se abre y se vuelve a cerrar, la configuración actual se aplica en las opciones de usuario, incluso cuando no se han realizado cambios activos.

Sintaxis:

--enforcesignedcompiledlibraries
ejemplo 58. Ejemplo
CODESYS.exe --project="D:\projects\test.library" --enforcesignedcompiledlibraries


Opción: --timestampingserverurl (establece la dirección del servidor de sellos de tiempo)

Si agrega esta opción después de la opción --project="<path of project file>", luego la dirección de Internet del servidor de marca de tiempo RFC-3161 (servidor de marcas de tiempo) se establece en el proyecto en el Pantalla de seguridad sobre el Usuario pestaña.

Importante

Cuando el Pantalla de seguridad se abre y se vuelve a cerrar, la configuración actual se aplica en las opciones de usuario, incluso cuando no se han realizado cambios activos.

Sintaxis:

--timestampingserverurl="<URL of RFC-3161 timestamping server>"
ejemplo 59. Ejemplo
CODESYS.exe --timestampingserverurl="http://timestamp.comodoca.com/rfc3161"


Opción: --enableEventLog

CODESYS se inicia y todas las ejecuciones de comandos se registran en el registro de eventos de Windows. Los registros se encuentran en Windows Visor de eventos bajo Registros de aplicaciones y servicios → AP.

Al utilizar esta opción por primera vez, CODESYS debe iniciarse con permisos de administrador.

Sintaxis:

--enableEventLog="CommandManager"

Opción: --ForceDisconnectAfterInactivity

Para esto CODESYS sesión, el tiempo de inactividad después del cual la conexión con el controlador finaliza automáticamente se establece en el tiempo especificado (en segundos). El valor especificado en esta opción anula el valor establecido en el CODESYS opciones en el En línea categoría para esto CODESYS sesión.

Si el valor se establece en 0, la conexión con el controlador no finalizará automáticamente después de un período específico de inactividad. Para esto CODESYS sesión, esto desactiva la opción de desconexión en el CODESYS opciones.

Sintaxis:

--ForceDisconnectAfterInactivity="<value in seconds>"
<value in seconds> : [10, 10800] | 0
ejemplo 60. Ejemplo

Después de 300 segundos de inactividad, la conexión con el controlador finaliza automáticamente.

--ForceDisconnectAfterInactivity="300"